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CP/M -> SOS TEXTMOVER 

Transfer CP/M Text Files to SOS 



by Arthur E. Anderson /// 




You say you're tired because your Softcard /// (CP/M) 
programs can't mingle with your SOS files? Do you feel 
run-down because you can't use CP/M files with Business 
BASIC, the Pascal screen editor or Pascal, Applewriter ///, 
Access ///, and all your (sigh) nifty programs under SOS? You 
say that your software transfers the data from SOS to CP/M 
files, but not from CP/M to SOS? You say that your Softcard is a 
data sink, and you want some of it back? 

Well, lift your head up high, fellow Apple///er, because this 
demented hacker has a cure for all of your ills (well, at least 
some of them). You need CP/M— >SOS TEXTMOVER. 
CP/M->SOS TEXTMOVER is the key that lets files helplessly 
trapped in CP/ M emerge to SOS; it will cure make you feel 
young again fast fast, FAST, will cure all of mankind's ills, and it 
tastes good too! (Perhaps I've overstated things a bit) 

CP/M->SOS TEXTMOVER is a program that transfers 
CP/M diskette files to SOS format files. If you transfer the CP/M 
file to a SOS floppy, then two diskette drives are required. 
CP/M— >SOS TEXTMOVER is menu driven, provides handy 
character filters, uses friendly I/ O error-trapping, and allows 
CP/M cataloging capability. In short, it conveniently fills the 
CP/M to SOS gap. 

Don't Blame Me . . . 

No warranties, express or implied are offered, as is the case 
with all software. The only difference is that we're stating this up 
front in the same size type as the rest of the article. Your sole 
recourse if you dislike this program is to erase the diskette and 
say nasty things about my ancestry. However, I have found this 
program an absolute godsend, if not a necessity, and I sincerely 
hope that you too will like this program. Best of all, this utility did 
not or will not set you back $100.00 or more. (And, it worked 



for me when we transferred the text for this and other articles 
from CPM to SOS. That means it should work for almost 
anybody.— PCW) 

Who's in Control Here? 

CP/M— >SOS TEXTMOVER is conveniently menu driven. 
The menu style was shamelessly stolen from the Apple /// 
utilities. It features cursor selection of input and output devices 
It uses multiple menu screens to prompt and inform you. It 
traps I/O errors and responds with human-intelligible error 
messages. And if you have an Apple /// clock chip installed, it 
even ticks away the time. 

Down to Business 

Figure 1 shows the main menu of CP/M— >SOS TEXTMOVER 
Typing 'L', the first choice on the menu, will list the catalog of 
CP/M files. The catalog listing includes filename and type, 
GSER number, the number of records used, file size in bytes, 
the number of file Extents used, the ACCess attribute, and the 
SYS/DIR attribute for each file on the diskette. Under CP/M, 
system files such as MAG2.TXT and MAG3.TXT are so 
indicated with parentheses. 

Typing "T", the second option of the main menu, initiates 
the "Transfer file" command. The program then requests a 
valid and unambiguous CP/M filename, as shown in Figure 2. 
(CP/M— >SOS TEXTMOVER considers upper and lower case 
filenames as different thereby allowing access to "system 
files" which can be in lower case ASCII and "directory" files 
which are always in UPPER case ASCII.) The CP/M filenamctyp 
is checked for syntax, and is verified to be on the disk The 
transfer then proceeds. 

Pascal I/O is not known for its lightning speed, so for long 
files, go get a cup of coffee. Just to show what's happening, 
CP/M->SOS TEXTMOVER provides a block count on the 
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screen while it s doing its work However, for faster operation 
you may turn the screen off (using the auxiliary keypad CTRL- 

Within- P ? 9ra « f tUm SCreen backon afteritfinshes 
Wrfh the display off, the transfer time will be reduced by about 
20% Transfer time is about 20 seconds per kilobyte when 
transferred to .CONSOLE, and 35 seconds per kilob^ ^ 
transferred to a floppy disk 



CP/H-->SQS TEXTHOVER 
HAIN MENU 



12:35:15 
Jul 13 19B3 



LUST CPH DIRECTORY 
TRANSFER FILE 

SIOURCE DRIVE I>D2J 

D(ESTINATION DEVICE '.['.CONSOLE! 

F(ILE ON DESTINATION DEVICE.... [] 

H(0DE OF TRANSFER CTEXT1 3 

B(0IT 



ENTER: L, S, T, D, F, H, OR B<UIT 

Figure 1 

CP/H-->S0S TEXTHOVER ~ ~ ~ 

HAIN HENU 12:35:15 

Jul 13 1983 

LdST CPH DIRECTORY 
TRANSFER FILE 

SUJURCE DRIVE [ D2J 

D(ESTINATION DEVICE '.'.'.[! CONSOLE 3 

FdLE ON DESTINATION DEVICE....!] 

H(00E OF TRANSFER [TEXT1J 

0(UIT 



ENTER CPH NAHE.TYPE 



Figure 2 



H J he two optjons on the m ain menu select the souTce 
dr ve and the destination device. After pressing the option 
rntt Th ,S m t de „ by u CUFSOr mani P^ion of an arrow which 
o^r CP/MT 9h a, u the POSSib,G Ch ° ices - Fi 9 ure 3 sh °ws the 
^Mn^ y ChOIC6S f ° r CP/M diskette - Cp /^- >SOS 
' W u? d r? 65 ,," 01 SUPP ° rt CP/M fi,es on hard disk, so 

TE^MOVFR H f,, K S t0 fl ° PPy ' if neCeSSa ^ CP/M->SOS 
I tA MOVER does, however, support output to the. PROFILE 
driver. For floppy-to-floppy transfers, two disk drives are 

WmI Xr S ° S t-nsfer most any 

fi,e ' wth tne exception of (rare) "random record" files 

When transferring data from a CP/M file, the destination 
device can be one of the following: .Dl, D2 D3 D4 

RS?^- C °^ - PR,NTER ' - PA ^Lku .sIlEnVyPe! 
•Kb232. Figure 4 illustrates this. 

in wNchT CP/M - >S S TEXTMOVER disallows a transfer 
in which the source and destination drives are the same 

™, Th inP f 3 ? d ° Utput devices is made with visual 
cursors The cursor facilitates quick assignment of an output 

34 Apple Orchard 



device. You can preview a file on the console, print the file on a 
pnnter ; and transfer the CP/M file to a SOS disk with a 

'Tc^ m ? f fuSS * For CP/M fi,es sent to disl < drives, a SOS 
• ASCI or DATA" file is created, based on the chosen mode 
of transfer. The .ASCI" filesare desirable because they maybe 

p£ST ^™ aSCal 3nd BAS,Q and Mother programs, 
rascal .TEXT files are not so accomodating! 



CP/H»>S0S TEXTHOVER 
HAIN HENU 



12:35:15 
Jul 13 1983 



LdST CPH DIRECTORY 
TRANSFER FILE 

SIOURCE DRIVE Lm 

DESTINATION DEVICE '.[ CONSOLE] 

FdLE ON DESTINATION DEVICE.... []" 

H(0DE OF TRANSFER fTEXTl] 

Q(UIT 



.Dl 
->.D2 
.D3 
.D4 



SOURCE DRIVE: UP/D0NN ARR0NS ROTATE, RETURN SELECTS, OR tESCI ESCAPES 

Figure 3 



CP/H->S0S TEXTHOVER 
HAIN HENU 



12:35:15 
Jul 13 1983 



LUST CPH DIRECTORY 
TRANSFER FILE 

SIOURCE DRIVE [ d 2 ] 

DESTINATION DEVICE '.[IcONSOLE] 

FdLE ON DESTINATION DEVICE.... 1 3 

H(0DE OF TRANSFER [TEXT1] 

0(UIT 



.Dl 
.D2 
.03 
.04 

.PROFILE 
>. CONSOLE 
.PRINTER 
.PARALLEL 

.SILENTYPE 
.RS232 



SOURCE DRIVE: UP/D0NN ARROWS ROTATE, RETURN SELECTS, OR [ESC] ESCAPES 

L Figure 4 



Where to Go 

If a CP/M file is to be transferred to disk, then a filename is 

req cA e cVDS- n9 " F ' from the main menu commands CP/M 
->SOS TEXTMOVER to request the pathname (including any 
ndesired subdirectories beyond the name of the destination 
device) Figure 5 shows such an example. This pathname is 

rrD/r^,! ^ main manu as shown in Fi 9 ure 6- Hence 
the CP/M file will be transferred to ".d2/letters/magazine.text". 
i he filename is ignored if the transfer is not made to disk. 

A la Mode, Please! 

Typing "M", the last choice of the main menu, results in the 
mode menu shown as Figure 7. One of four modes of transfer 
may be chosen. Each mode represents a different set of 
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character filters applied to the transfer. This option allows the 
filtering out of nasty unprintable ASCII characters Four filter 
options are offered which range from an unfiltered binary 
transfer to a transfer consisting of a very simple ASCII character 



CF7H~>S0S TEXTKOVER 
FILE-TO-NRITE ENTRY 



13:42:34 
Jul 13 1983 



IF THE DESTHMTION.DEVICE IS DISK , THEN A PATHNAME IS REQUIRED. 

OTHERWISE IT IS I6N0RED. 

PLEASE ENTER PATHNAME ON DESTINATION DEVICE AND [RETURN] 
OR 

«ESC> RETURN TO ESCAPE) 



APPLE! 

Figure 5 

CP/H~>S0S TEXTKOVER ' 
RAIN MENU 

LUST CPM DIRECTORY 
TRANSFER FILE 

S(0URCE DRIVE [.02] 

DESTINATION DEVICE [.CONSOLE! 

FULE ON DESTINATION DEVICE.... [APPLE] 

N(0DE OF TRANSFER [TEITU 

Q4UIT 



12:35:15 
Jul 13 19S3 



ENTER: L, S, T, D, F, N, OR 0(UIT 



Figure 6 



set The binary transfer results in a ".DATA" file A very handy 
mode is the "TEXT1 " mode of transfer, which limits the 
character set to the printable ASCII, «RETCIRN», and «SPACE». 
This mode also reexpandstabs to every 8 columns. The mode 
menu explains each of the four preconfigured modes. Should 
you feel like inventing a new mode feel free to hack at the 
source code and make a filter to your liking. That's an 
advantage of having the source code. 

A Secret Map 

The way that CP/M stores data on a diskette at first, 
appeared as a secret Armed with a disk zap routine a sleepless 
night and some researched information on Apple II and 
Apple /// formats, I proceeded to tear apart known CP/M for- 
matted diskettes. The Apple II CP/M format is referred to as 
"Format RR", and appears to be mostly the same for Apple/// 
CP/M This program has been used with both. 

But all the Sectors Look the Same. 

CP/M assigns each track to have 4 blocks of 1024 bytes (4 
sectors) each. Consider a CP/M disk addressing scheme 



CP/H~>S0S TEXTKOVER 
HODE.OF TRANSFER MENU 



16:38:83 
Jul 13 1983 



I.-.TEITl" TRANSFERS THE DATA INTO AN .ASCI TEXT FILE. IT LIHITS 
THE CHARACTER SET TO: PRINTABLE ASCII, CR, SPACE. IT EXPANDS 
TABS TO EVERY 8 COLUMNS. ALL OTHER CHARACTERS ARE FILTERED OUT. 
(THIS IS USEFULL FOR EDITORS.) 

2...'TEXT2" TRANSFERS THE DATA INTO AN .ASCI TEXT FILE. IT LIMITS 
THE CHARACTER SET TO: PRINTABLE ASCII.ACK, BEL, BS, HT, LF, 
VT, FF, CR, SO, SI, OLE, NAK, ESC, SPACE. ALL OTHER CHARACTERS 
ARE FILTERED OUT. (USEFUL FOR LINEPRINTER OUTPUTS.) 

3..."TEXT3" TRANSFERS DATA INTO AN .ASCI TEXT FILE. 

ONLY CNTRL-C(PASCAL EOF) IS FILTERED OUT. THIS NAY HAVE 
STRANGE EFFECTS ON NONDISK DRIVERS. USE WITH CARE! 

4... 'BINARY* TRANSFERS THE DATA (BYTE FOR BYTE) INTO A .DATA FILE. 
NO TRANSLATION IS HADE ON THE DATA. THIS NAY HAVE STRANGE 
EFFECTS ON NONDISK DRIVERS. USE NITH CARE! 




where we start addressing at physical track 3. We continue 
addressing to track 35, then wrap around and pickup tracks 0, 
1, and 2. Therefore CP/M logical blocks 0, 1, 2, and 3 are on 
physical track 3. CP/M logical blocks * 124 ... 127 are on 
physical track35 and CP/M logical blocks * 1 28 ... 1 39 are on 
physical tracks 0, 1, and 2. 

The Apple/// blockread procedure reads 5 12-bytes, Le two 
256-byte sectors The high and low part of the 8 blockreads per 
track therefore yield the well known sixteen sectors per track 
CP/M->SOS TEXTMOVER addresses each sector by using 
either the high 256 bytes, or the low 256 bytes of the blockread 
The required disk mappings and formulas were derived, by 
disk zapping many files The details of the disk mappings are 
contained in the Pascal source code 

F.Y.L 

I hope this program solves your CP/M to SOS transfer 
problems and illuminates some of the CP/M data structures 
For further reading on the subject I recommend the following 
references: 

1. Art Messeler, "Disk Mapping the Z-80 CP/M System" 
Call -A.P.P.LE December 1982, pp. 45 & 46. 

2. Dr. Jay H. Lieske, in a letter, 

Call -AP.P.L£,February 1983, p. 66. 

3. Val J. Golding, "CP/MUFFIN", 

Call APPLE, March 1983, pp. 81-86. 

4. Inside CP/M, A guide for Users and Programmers 
with CP/M-86 and MP/M2, by David Cortessi, 
Holt Rinehart And Winston, © 1982. 

5. "CP/M USER", David P. Babcock, Journal of 
Pascal and ADA, Jan-Feb. 1983, pp. 13-14 

6. Softcard /// manuals from Apple Inc 

7. Apple /// Pascal manuals from Apple, Inc. 

8. Timothy C. O' Konski, "A Little Apple SOS with Your Pascal" 
BYTE, December 1982, pp. 448-482. 

8. Apple /// SOS Reference Manual (Draft), 
copyright 1982, Apple Computer, Inc. 

9. The Apple /// Pascal Technical Reference Manual (Draft), 
copyright 1982, Apple Computer, Inc. 

10. SOS Device Driver Writers Guide (Beta Draft), 
copyright 1982, Apple Computer, Inc. • 
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Apple III User 



CP/M-^ SOS TEXTmover 



System 
Configuration 

Features 



Cost 



To Order 



> Apple III computer 

> Two Apple III disk drives 

> 128K of memory 

Does not require softcard 
Ready to run—just boot 
Source Code 
Character filters 

Reads only CP/M floppies using Apple drives 

$25°° (California residents add 6.5% Sales Tax) 



Send check or money order to: 

International Apple Core, 908 George Street, Santa Clara, CA 95050 
Make check or money order payable to International Apple Core 
US m ba n nk USt accompany order and must be in u - & funds and drawn on 
Dealer inquiries invited 




INTERNATIONAL 
APPLE CORE tm 



Apple and Apple III are registered trademarks of Apple Computer, Inc. 



■ Ill' ■ 




$79.95 v*a^ as,e 
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